.. _cmmDoPutMulti:

cmmDoPutMulti
============================
----------------------------

SYNOPSIS
```````````

.. code-block:: none

    VT_I4 cmmDoPutMulti(
        [in] VT_I4 IniChannel, [in] VT_I4 NumChannels,
        [in] VT_I4 OutputStates
        )



DESCRIPTION
```````````````

- 다중 채널에 대한 디지털 출력 혹은 출력 상태를 확인(確認)합니다. 이 상태는 cmmDoSetOutputLogic() 함수를 통해
  설정된 디지털 출력 논리(Digital Output Logic)가 적용됩니다. 시작 채널부터 설정된 범위의 채널에 대한 Digital 출력
  상태값을 얻습니다.

\

- cmmDoPutMulti() 는 IniChannel 에서 지정한 채널부터 NumChannels 의 수 만큼의 다중 채널에 대해서 디지털 출력을
  발생합니다.

PARAMETER
```````````

- IniChannel : 시작 채널번호. 채널번호는 상수 값으로 0 번째 채널을 기준채널로 임의의 채널을 설정 할 수
  있습니다.

\

- umChannels : 대상 채널 개수.

\

- OutputStates : cmmDoPutMulti 함수의 인자인 OutputStates 는 다중 채널에 대한 출력 상태를 설정합니다. 이 출력
  상태는 BitMask (비트 마스크) 로 설정되며, 설정된 비트가 1 일 경우 디지털 출력(Digital Output)이 발생합니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0, OFF
  1, ON

RETURN VALUE
`````````````

- cmmDoGetMulti 함수의 리턴값은 다음과 같습니다.
  사용자가 의도한 지정한 다중 출력 채널에 대해 실제 확인하게 된 하드웨어 채널 갯수를 반환합니다.
  
.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  cmERR_NONE, 수행 성공